home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / cmds.fmt / ar.sprite.man < prev    next >
Text File  |  1992-04-14  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. AR                        User Commands                        AR
  5.  
  6.  
  7.  
  8. NNAAMMEE
  9.      ar - archive and library maintainer
  10.  
  11. SSYYNNOOPPSSIISS
  12.      aarr key [ posname ] afile name ...
  13.  
  14. DDEESSCCRRIIPPTTIIOONN
  15.      _A_r maintains groups of files combined into a single archive
  16.      file.  Its main use is to create and update library files as
  17.      used by the loader.  It can be used, though, for any similar
  18.      purpose.  NN..BB:: This version of _a_r uses a ASCII-format
  19.      archive which is portable among the various machines running
  20.      UNIX.  Programs for dealing with older formats are avail-
  21.      able: see _a_r_c_v(8).
  22.  
  23.      _K_e_y is one character from the set ddrrqqttppmmxx,, optionally con-
  24.      catenated with one or more of vvuuaaiibbccllooLL.. _A_f_i_l_e is the
  25.      archive file.  The _n_a_m_e_s are constituent files in the
  26.      archive file.  The meanings of the _k_e_y characters are:
  27.  
  28.      dd    Delete the named files from the archive file.
  29.  
  30.      rr    Replace the named files in the archive file.  If the
  31.           optional character uu is used with rr,, then only those
  32.           files with `last-modified' dates later than the archive
  33.           files are replaced.  If an optional positioning charac-
  34.           ter from the set aabbii is used, then the _p_o_s_n_a_m_e argument
  35.           must be present and specifies that new files are to be
  36.           placed after (aa) or before (bb or ii) _p_o_s_n_a_m_e.  Otherwise
  37.           new files are placed at the end.
  38.  
  39.      qq    Quickly append the named files to the end of the
  40.           archive file.  Optional positioning characters are
  41.           invalid.  The command does not check whether the added
  42.           members are already in the archive.  Useful only to
  43.           avoid quadratic behavior when creating a large archive
  44.           piece-by-piece.
  45.  
  46.      tt    Print a table of contents of the archive file.  If no
  47.           names are given, all files in the archive are tabled.
  48.           If names are given, only those files are tabled.
  49.  
  50.      pp    Print the named files in the archive.
  51.  
  52.      mm    Move the named files to the end of the archive.  If a
  53.           positioning character is present, then the _p_o_s_n_a_m_e
  54.           argument must be present and, as in rr,, specifies where
  55.           the files are to be moved.
  56.  
  57.      xx    Extract the named files.  If no names are given, all
  58.           files in the archive are extracted.  In neither case
  59.           does xx alter the archive file. Normally the `last-
  60.  
  61.  
  62.  
  63. Sprite v1.0              April 29, 1985                         1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. AR                        User Commands                        AR
  71.  
  72.  
  73.  
  74.           modified' date of each extracted file is the date when
  75.           it is extracted. However, if oo is used, the `last-
  76.           modified' date is reset to the date recorded in the
  77.           archive.
  78.  
  79.      vv    Verbose.  Under the verbose option, _a_r gives a file-
  80.           by-file description of the making of a new archive file
  81.           from the old archive and the constituent files.  When
  82.           used with tt,, it gives a long listing of all information
  83.           about the files.  When used with pp, it precedes each
  84.           file with a name.
  85.  
  86.      cc    Create.  Normally _a_r will create _a_f_i_l_e when it needs
  87.           to.  The create option suppresses the normal message
  88.           that is produced when _a_f_i_l_e is created.
  89.  
  90.      ll    Local.  Normally _a_r places its temporary files in the
  91.           directory /tmp.  This option causes them to be placed
  92.           in the local directory.
  93.  
  94.      LL    No lock.  By default, _a_r performs an _f_l_o_c_k() call when
  95.           accessing archives.  If this modifier is specified, no
  96.           lock is obtained.  This is used by _r_a_n_l_i_b, which locks
  97.           the archive before calling _a_r.
  98.  
  99. FFIILLEESS
  100.      /tmp/v*   temporaries
  101.  
  102. SSEEEE AALLSSOO
  103.      lorder(1), ld(1), ranlib(1), flock(2), ar(5), arcv(8)
  104.  
  105. BBUUGGSS
  106.      If the same file is mentioned twice in an argument list, it
  107.      may be put in the archive twice.
  108.  
  109.      The `last-modified' date of a file will not be altered by
  110.      the oo option if the user is not the owner of the extracted
  111.      file, or the super-user.
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Sprite v1.0              April 29, 1985                         2
  130.  
  131.  
  132.  
  133.